home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / tt / cal45 / calshow.doc < prev    next >
Encoding:
Text File  |  1996-09-18  |  4.8 KB  |  111 lines
  1.              CalShow v4.5  --  Copyright (c)1991 by Bill Aycock
  2.  
  3.  
  4. CalShow is designed to run from your AUTO folder when you boot your ST. It
  5. will find Cal, read all your events, and display an entire screen's worth of
  6. events so you can easily see what's on tap for the next few weeks.
  7.  
  8. You can also run CalShow from the desktop as a .TTP program. If you do so,
  9. you have the option of telling CalShow to:
  10.  
  11.         * print out the list of upcoming events
  12.         * save the list to a disk file
  13.         * specify the number of events to list
  14.         * specify a starting or ending date for the display
  15.         * tell CalShow where to look for Cal
  16.  
  17.  
  18. * Installing CalShow as an AUTO program
  19.  
  20.  
  21. There are two steps involved in installing CalShow in your AUTO folder.
  22. First, you need to create a special "configuration file" which will be read
  23. when CalShow runs. This file must be called CALSHOW.PTH, and should be kept in
  24. the root directory of your boot disk. CALSHOW.PTH is a standard ASCII text file
  25. which can be created and edited with just about any ST word processor or text
  26. editor (as long as your editor has an option to 'Save as ASCII'). This file
  27. tells CalShow where it should look for the Cal program file. Just type in the
  28. full filename and path of your Cal program, hit Return, and save the file. The
  29. filename should be flush with the left side of the screen; don't add any spaces
  30. in front of the filename. Here's an example of a valid CALSHOW.PTH file:
  31.  
  32. C:\DESKACCS\CAL45.ACC
  33.  
  34. That one line is all it takes! The file CALSHOW.PTX included in this ARC is a
  35. sample CalShow path file; take a look at it if you have any questions.
  36.  
  37. If CalShow doesn't find its CALSHOW.PTH file, it will look for Cal in two
  38. places before it gives up. First it will try to find a file named \CAL????.AC?
  39. on your boot disk. (The question mark is a 'wildcard', which matches any
  40. character; see your ST Owner's Manual for more information.) If that doesn't
  41. work, CalShow will look for \ACCS\CAL????.AC? on your boot disk. (This means
  42. that if you don't rename Cal AND you have Cal in either your root directory or
  43. in a folder named \ACCS\, then you don't need to create a CALSHOW.PTH file.) If
  44. CalShow can't find Cal anywhere it looks, it will tell you so when it runs.
  45.  
  46.  
  47. When you have your CALSHOW.PTH file set up, just copy CALSHO44.PRG into the
  48. AUTO folder on your boot disk. Then, next time you boot up, you should see a
  49. screen of upcoming events automatically! The display sticks around for fifteen
  50. seconds, then the boot process continues. If you'd rather not wait the full
  51. fifteen seconds, just press any key to continue booting.
  52.  
  53.  
  54. * Running CalShow from the desktop
  55.  
  56.  
  57. You can run CalShow from the desktop like any other program. Rename the file
  58. to have the extension .TTP, then double-click on its icon. When you see a
  59. dialog box asking you to enter parameters for the program, you can enter any
  60. combination of these commands:
  61.  
  62.     ?              display a screen showing the possible commands
  63.     p              print (ignored if printer isn't online and ready)
  64.     p<filespec>    print output to a file (specify full filespec!)
  65.     =<filespec>    specify Cal's full filename (overrides CALSHOW.PTH)
  66.     n<number>      specify the number of upcoming events to list
  67.     s<mmddyyyy>    specify a starting date for the event list
  68.     e<mmddyyyy>    specify an ending date for the event list
  69.     <number>       seconds to pause (1-999, default is 15 seconds)
  70.  
  71. Commands may be upper or lower case, and must be separated with blanks. You
  72. can enter the commands in any order. If you type the same command twice, the
  73. information from last one you enter will be used. If you don't pass any
  74. commands at all, CalShow will simply display one screen of events and pause for
  75. 15 seconds.
  76.  
  77. Don't include the <> characters in your commands. For the commands that need
  78. a <filespec>, enter a full filename including the drive letter, path, and
  79. filename. For a <number>, enter a group of decimal digits. For starting and
  80. ending dates shown as <mmddyyyy>, use a two-digit month number, a two-digit
  81. date, and a four-digit year. If the date you enter doesn't make any sense
  82. (e.g., the ending date precedes the starting date), Cal will use a reasonable
  83. value instead of what you entered.
  84.  
  85.  
  86. Here are a few examples of CalShow commands:
  87.  
  88.   1. Show 50 events starting Nov 25, 1991 and save to A:\EVENTS.TXT...
  89.  
  90.           pa:\events.txt n50 s11251991
  91.  
  92.   2. Print events in D:\CAL.PRG occurring between now and Christmas...
  93.  
  94.           p =d:\cal.prg e1225
  95.  
  96.   3. List events this year and next year, and pause for two minutes...
  97.  
  98.           s01011991 e12311992 120
  99.  
  100.  
  101. The program is pretty straightforward to use. If you have any questions or
  102. comments, let me know!
  103.  
  104.  
  105.       Bill Aycock
  106.       2310 North Elm Street
  107.       Greensboro, NC 27408
  108.  
  109.       Compuserve ID: 76703,4061
  110.       February 17, 1991
  111.